home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / language / iconv8_e.arc / DOCS.ARC / ASH076.DOC < prev    next >
Text File  |  1989-03-07  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4.                                    - 1 -
  5.  
  6.  
  7.  
  8.                                  ASH V0.76
  9.  
  10.                       Copyright (c) 1986,1987 CSL/jdn
  11.  
  12.  
  13.          This is an ADDENDUM to the ASH V0.70 Document (ash.doc).
  14. ASH Version 0.76 is a minor update.  It's not big enough to warrant a new
  15. version of the ASH document but there are several significant changes that
  16. have to be explained and this document does that.
  17.  
  18. There are two new built-in commands included in V0.76.  The history buffer
  19. size is now user definable.  There is now an ASH history file that is read
  20. in when ASH is invoked interactively and written back when ASH exits.  The
  21. ^V character has changed slightly in it's use and the ^B character now has
  22. meaning.  The UP ARROW key is now active for previous command retrieval
  23. without hitting the escape key.  Finally, the environment (set variables)
  24. is now passed in a manner that will allow programs written to Atari's
  25. specifications for environment passing to get at them.
  26.  
  27. Another change that doesn't require any documenting is an improved
  28. readline() function that speeds up the find command and other commands that
  29. call readline() by a factor of about six.
  30.  
  31. cmp file1 file2
  32.      The cmp command takes two arguments as file names and compares the
  33.      them line by line.  If it finds lines that differ it exits with the
  34.      line number and each of the lines.  If one of the files is shorter
  35.      than the other that fact and the line number after which the file
  36.      ended is reported.  If there are no differences in the files that's
  37.      reported too.  ASCII files are strongly recommended.
  38.  
  39. where cmd [cmd ...]
  40.      The where command takes commands as you would type them into ASH as
  41.      arguments and looks for the arguments using the same search method as
  42.      if it were trying to invoke them.  No arguments should be include for
  43.      the commands given as arguments to where.  Built-in commands are
  44.      indicated as functions by following them with parentheses.  For other
  45.      commands the complete file name, including extension, and the path
  46.      where they were located is printed.
  47.  
  48. The ASH command history buffer can now retain as many command lines as you
  49. want.  The default size is 23 commands.  To change the default you define
  50. the set variable HISTSIZE to the number of history commands you would like.
  51. This must be done in your ASH initialization file 'ash.ini'.  The size of
  52. the history buffer is ONLY settable during initialization.  You can
  53. redefine the HISTSIZE set variable after initialization but it will not
  54. effect the size of the history buffer.  When listing the history buffer
  55. commands with the ^L, normal ASH pagination will keep the listing from
  56. getting away from you.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                    - 2 -
  71.  
  72.  
  73.  
  74. The file 'ash.hst' will be looked for in the same manner that the help file
  75. (ash.hlp) and the initialization file (ash.ini) are looked for during ASH
  76. initialization.  If it's found the commands in the file will be read in and
  77. added to the current command history buffer.  When ASH exits, the current
  78. command history buffer will be written back over the same file.  If you
  79. want to create a file of commands to be added to the history, but you don't
  80. want them to be over written, you can change the history file attributes to
  81. READ ONLY with the attr command.
  82.  
  83. The UP ARROW key is now active for history buffer command retrieval even
  84. before you hit the escape key.  Now you can immediately start going back
  85. through previous commands with the UP ARROW.  Keep in mind that once you
  86. start browsing through history commands you are in history edit mode.
  87. Pressing the UP ARROW is equivalent to pressing the ESC and then the UP
  88. ARROW.
  89.  
  90.  
  91. ^V        The ^V character now toggles the cursor back and forth between
  92.           visible and invisible instead of always trying to turn the cursor
  93.           on.
  94.  
  95. ^B        The ^B character toggles back and forth between a blinking and
  96.           non-blinking cursor.
  97.  
  98. In addition to being able to toggle the cursor attributes the program now
  99. remembers what the cursor was like before executing an external program and
  100. resets it on exit.  For example, this will make your cursor reappear after
  101. exiting MicroEMACS.
  102.  
  103. Finally, the environment is now passed to external commands as a string of
  104. the form:
  105.  
  106.         var=val\0var=val\0var=val\0...var=val\0\0
  107.  
  108. Each variable and value is NULL terminated and the entire list is NULL
  109. terminated as well.  This is the way Atari recommended and the way that
  110. several shells (MWC, Micro C shell) do it now.  I'll provide the code for a
  111. getenv() function you can use in external programs on request.
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.